ListBox.DrawMode Property 



Page 1 of 2 



.NET Framework Class Library 

ListBox.DrawMode Property 

See Also Example 

H Collapse All <* Language Filter: Visual Basic 

Gets or sets the drawing mode for the control. 
Namespace: System. Windows. Forms 

Assembly: System. Windows. Forms (in system.windows.forms.dll) 

1 Syntax 

Visual Basic (Declaration) 

Public Overridable Property DrawMode As DrawMode 

Visual Basic (Usage) 

Dim instance As ListBox 
Dim value As DrawMode 

value = instance ■ DrawMode 

instance. DrawMode = value 

Property Value 

One of the DrawM ode values representing the mode for drawing the items of the control. The default 
is DrawMode.Normal. 



3 Exceptions 

Exception type Condition 



InvalidE nu mArq ume n t Ex ce p t i o n The value assigned to the property is not a member of the 

DrawMode enumeration. 



ArgumentException A multicolumn ListBox cannot have a variable-sized height. 



- Example 

The following code example demonstrates how to create owner-drawn ListBox items. The code uses 
the DrawMode property to specify that the items drawn are fixed sized and the Drawltem event to 
perform the drawing of each item into the ListBox. The example code uses the properties and 
methods of the DrawItemEventArqs class passed as a parameter to the event handler to draw the 
items. This example requires that a ListBox control called listBoxi has been added to a form and 
that the Drawltem event is handled by the event handler defined in the example code. The 
example also requires that items have been added to the ListBox with the text of "Apple", 
"Orange", and "Plum" in that order. 

Visual Basic 

Private Sub listBoxl_DrawItem (ByVal sender As System . Ob j ect , ByVal e As System. Windc 
' Set the DrawMode property to draw fixed sized items. 
ListBoxi . DrawMode = DrawMode . OwnerDrawFixed 
' Draw the background of the ListBox control for each item, 
e . DrawBackground ( ) 

' Define the default color of the brush as black. 
Dim myBrush As Brush 

1 Determine the color of the brush to draw each item based on the index of the it 
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Select Case (e 
Case 

my Brush 
Case 1 

my Brush 
Case 2 

myBrush 
End Select 



Index) 
Brushes . Red 
Brushes . Orange 
Brushes . Purple 



' Draw the current item text based on the current Font and the custom brush setti: 
e . Graphics .Drawstring (ListBoxl . Items (e . Index) , e . Font , myBrush, New RectangleF (e . : 

' If the ListBox has focus, draw a focus rectangle around the selected item, 
e . DrawFocusRectangle ( ) 
End Sub 



- Platforms 



Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, 

Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, 

Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition 

The .NET Framework does not support all versions of every platform. For a list of the supported 
versions, see Syst em Requi remen ts. 

1- Version Information 

.NET Framework 

Supported in: 2.0, 1.1, 1.0 

3 See Also 

Reference 

ListBox Class 
ListBox Members 

System. Windows-Forms Namespace 

Draw Mode 

Drawltem 



Send comments about this topic to Microsoft. 
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